Weaveでは、保存されたビューを使用して、トレースされた関数呼び出しと評価の操作方法をカスタマイズできます。保存されたビューを定義することで、フィルター、ソート、列の表示を設定し、関連データに素早くアクセスできます。 Weave Python SDKまたはUI経由でビューを作成、変更、保存できます。Python SDKはプログラムによるフィルタリングとクエリのための細かい制御を提供し、UIではTracesおよびEvalsタブで異なるテーブル構成を簡単に探索して保存できます。 このガイドでは以下をカバーします:

Python SDKでの保存されたビュー

WeaveのSavedViewクラスは、トレースと評価データのビューを保存、フィルタリング、ソート、カスタマイズする方法を提供します。

初期化SavedView

WeaveプロジェクトでSavedViewインスタンスを初期化します:
import weave
client = weave.init(<my_project>)

view = weave.SavedView()

可視化SavedViewをグリッドとして表示

使用.to_grid()で保存されたビューをグリッドとして表現します。表示する最大行数をlimitで指定します。
view.to_grid(limit=5)
グリッド表現を.show()を使用して表示します:
view.to_grid().show()

表示する列を設定

使用.set_columns()でビューに表示する列を設定します。表示する列を1つ以上指定します。
view.set_columns("id", "op_name")

列を追加

使用.add_column()でビューに1つ以上の新しい列を追加します。追加する列を1つ以上指定します。
# Add a column with the field specifier and label "Created"
view.add_column("Created")
# Optionally, you can add a second argument to specify a different label name for the new column. By default, the field specifier is use for the label.

列をソート

使用.sort_by()で特定の列に基づいて結果をソートします。ソートする列名とソート順序(ascまたはdesc)を指定します。
view.sort_by("started_at", "desc")

操作名でフィルタリング

Weaveでは、すべてのトレースまたは評価は操作名に関連付けられています。 使用.filter_op()SavedViewをフィルタリングして、特定の操作が実行された呼び出しのみを含めます。
view.filter_op("Evaluation.predict_and_score")

演算子と条件でフィルタリング

使用.add_filter()でビューにカスタムフィルターを適用します。サポートされているフィルター演算子のいずれかと条件を使用してフィルターを定義します。
view.add_filter("output.model_latency", ">=", 5)

フィルター演算子

演算子説明
"contains"文字列がサブ文字列を含むかどうかをチェックします。view.add_filter("output.status", "contains", "error")
"equals"文字列が指定された値と完全に一致するかどうかをチェックします。view.add_filter("input.category", "equals", "Alice")
"in"文字列が値のリストに含まれているかどうかをチェックします。view.add_filter("category", "in", ["A", "B", "C"])
"="数値が値と等しいかどうかをチェックします。view.add_filter("output.score", "=", 80)
"≠", "!="数値が値と等しくないかどうかをチェックします。view.add_filter("metrics.loss", "!=", 0.5)
"<"数値が値より小さいかどうかをチェックします。view.add_filter("age", "<", 30)
"≤", "<="数値が値以下かどうかをチェックします。view.add_filter("metric.value", "<=", 100)
">"数値が値より大きいかどうかをチェックします。view.add_filter("output.score", ">", 90)
"≥", ">="数値が値以上かどうかをチェックします。view.add_filter("output.model_latency", ">=", 5)
"is"ブールフィールドがTrueまたはFalseかどうかをチェックします。view.add_filter("is_active", "is", True)
"after"日付が指定されたタイムスタンプより後かどうかをチェックします。view.add_filter("started_at", "after", "2024-01-01")
"before"日付が指定されたタイムスタンプより前かどうかをチェックします。view.add_filter("ended_at", "before", "2024-12-31")
"is empty"フィールドが空(Noneまたは"")かどうかをチェックします。view.add_filter("comments", "is empty", None)
"is not empty"フィールドが空でないかどうかをチェックします。view.add_filter("attachments", "is not empty", None)

フィルターを削除

使用.remove_filter()でインデックスまたはフィールド名によって特定のフィルターをビューから削除します。
view.remove_filter("output.model_latency")
使用.remove_filters()ですべてのフィルターを削除します。
view.remove_filters()

保存SavedView

使用.save()で保存されたビューをWeaveに公開します。
view.save()

関数呼び出しを取得

使用.get_calls()で保存されたビューのフィルターに一致する関数呼び出しを取得します。limitoffsetなどのオプションパラメータを指定できます。
calls = view.get_calls(limit=10)

UIでの保存されたビュー

Weave UIで保存されたビューを作成、読み込み、名前変更、編集できます。細かい制御が必要な場合は、Python SDKを使用してください。

保存されたビューを作成

  1. あなたのTracesまたはEvalsタブに移動します。
  2. テーブル構成で以下の変数を調整します:
    • フィルター
    • ソート順
    • ページサイズ
    • 列の表示
    • 列の固定
  3. 次の2つのオプションのいずれかを使用してビューを保存します:
    • 右上隅でSave viewをクリックします。
    • 左側のSave viewの横にあるハンバーガーメニューをクリックします。ドロップダウンメニューで+ Save as new viewをクリックします。

保存されたビューを読み込む

  1. あなたのTracesまたはEvalsタブに移動します。
  2. タブタイトルの左側にあるハンバーガーメニューをクリックします。保存されたすべてのビューを表示するドロップダウンメニューが表示されます。
  3. アクセスしたいビューをクリックします。保存されたビューがTracesまたはEvalsタブに表示されます。

保存されたビューの名前を変更する

  1. 以下の手順に従ってください:保存されたビューを読み込む
  2. 左上隅のTraces または Evals タブで、ビュー名をクリックします。
  3. ビューの新しい名前を入力します。
  4. 新しいビュー名を保存するには、Enterキーを押します。

保存したビューを編集する

  1. 以下の手順に従ってください:保存したビューを読み込む
  2. テーブル設定を調整します。
  3. 右上隅でSave viewをクリックします。

保存したビューを削除する

ビューがあなたやチームにとってもう役に立たないと思われる場合は、削除することができます。この操作は元に戻せません。
  1. あなたのTracesまたはEvalsタブに移動します。
  2. 削除したいビューを読み込みます。
  3. Save viewの左側にあるハンバーガーメニューをクリックします。Save view
  4. ドロップダウンメニューでDelete viewをクリックします。
  5. ポップアップモーダルでDelete viewをクリックして確認します。またはCancelをクリックして削除を中止します。

デフォルトビューに戻る

  1. あなたのTracesまたはEvalsタブに移動します。
  2. TracesまたはTracesまたはEvalsタブの右側にあるハンバーガーメニューをクリックします。保存されたすべてのビューを表示するドロップダウンメニューが表示されます。
  3. メニューの一番下でTracesまたはEvalsをクリックします。デフォルトビューが表示されます。